home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 2 / ETO Development Tools 2.iso / Tools - Objects / Virtual User 1.0b5 / Release Notes < prev    next >
Encoding:
Text File  |  1990-10-05  |  7.6 KB  |  173 lines  |  [TEXT/MPS ]
  1.  
  2.  
  3.                 Virtual User 1.0b5 Release Notes
  4.  
  5.  
  6. This is a beta release of the Virtual User  (VU) test automation 
  7. system.  This release package comes in the form of two 800K disks 
  8. and four documents. The four documents are as follows:
  9.  
  10. 1.    Virtual User General Reference: The first time user is 
  11.     suggested to start by reading this document.  It describes the 
  12.     general architecture of the system and how to make effective use
  13.     of it for test automation.
  14.  
  15. 2.    Virtual User Language Reference: This is a reference manual for 
  16.     the scripting language that has been designed to specify VU-driven
  17.     tests.
  18.  
  19. 3.    Virtual User Release Notes (this document)
  20.  
  21. 4.    VU Recorder Reference Manual: This describes the sister application
  22.     VU Recorder which can be used to augment the utility of VU.  The 
  23.     Virtual User General Reference has a chapter on how to use VU Recorder
  24.     in conjunction with VU.
  25.  
  26. The two disks are as follows:
  27.  
  28. 1.    Virtual User Program: This disk contains the Virtual User system which 
  29. is comprised of the following main items.  The Virtual User General Reference 
  30. describes how to install VU on your machine using the contents of this disk.
  31.  
  32. •    Virtual User folder: VU, the MPW tool which runs the VU scripts, is
  33.     located here.  Other items in this folder are used to set up a VU 
  34.     environment in MPW.
  35.  
  36. •    Agent VU: This is the system Init which sits in the test machine's 
  37.     system folder.
  38.  
  39. •    Supplements: This folder contains other supplementary items like 
  40.     VU Recorder, special items needed to test MacApp applications, etc.
  41.  
  42. 2.    Virtual User Samples: This disk provides you with some example VU
  43.     scripts and some example libraries to get you started.  Each of the 
  44.     example scripts has a header which describes its purpose and the setup
  45.     required to run it.
  46.  
  47.  
  48. VU Installation
  49.  
  50. To be able to use Virtual User you must start by reading the Virtual 
  51. User General Reference document.  This document describes the system, 
  52. its installation procedure and other facts you must know to use VU 
  53. effectively.
  54.  
  55.  
  56. Things to note
  57.  
  58.  •    MacApp Support 
  59.     Virtual User has problems running against MacApp applications due to
  60.     reasons described in the chapter  “Running VU Against Applications built 
  61.     with MacApp” in the Virtual User General Reference document.  We provide
  62.     a Agent VU hook for MacApp applications to enable the application to
  63.     become VU friendly.  You will have to build your MacApp application with 
  64.     this hook to be able to test it with VU successfully.  The source code
  65.     for the hook and the accompanying document are available in the 
  66.     Supplements folder in the Virtual User Program disk.  A sample application
  67.     built using this hook and a VU script which runs against it is available
  68.     in the Virtual User Samples disk.
  69.  
  70. •    Popup Support
  71.     We have implemented support for popup menu selections and matching for 
  72.     those applications that use the CDEF (CDEF id = 63) which comes with 
  73.     System 7.0 or the one which the Macintosh Communication Toolbox uses. 
  74.     Please contact Apple Software Licensing regarding the use of the 
  75.     Communication Toolbox CDEF.  It is not possible to retrofit applications
  76.     that use the scheme outlined in Inside Mac vol. V.
  77.  
  78. •    Warnings for reserved word use
  79.     We are trying to safeguard against possible name conflicts with future
  80.     versions of VU.  VU will now warn against the use of a particular name
  81.     (e.g. variable, task name) that may conflict with our future plans.
  82.     This will not prevent you from using it now as there are no semantics
  83.     tied to those words at present.  If you want to know whether a particular
  84.     script has any names that may conflict with the future without actually 
  85.     executing the script, you can use the compile only option (-c).
  86.  
  87.  
  88. Known Problems
  89.  
  90. 1.    Task definitions with task calls in the default values for their 
  91. arguments do not work properly.  For example,
  92. task test (arg1 := foo()) begin…end; 
  93. where foo() is a task call.  The task call given as the default argument will
  94. always evaluate to undefined.
  95.  
  96. 2.    The grow trait for windows may be reported to be true when the window has
  97. no visible  grow box.  This occurs with windows which are technically document
  98. windows with grow boxes, but which choose not to draw the grow box.  There is
  99. no known problem with the reverse case, which is to say VU will not indicate
  100. that a window lacks a grow box when it really has one.
  101.  
  102. 3.    VU will erroneously report that it has lost contact with its target if an
  103. matching operation is attempted while the target's mouse button is pressed in 
  104. the menubar, a window's title bar, grow box, any control, or a menu selection
  105. is in progress.  This problem arises when the target mouse is operated with 
  106. the primitive mouse operation pressMouse and no corresponding releaseMouse 
  107. commandis given before matching is attempted or when some person holds the
  108. mouse buttondown while VU is operating the target.  At present, there is no
  109. fix availableto us for this problem.
  110.  
  111. 4.    There may be problems with situations where VU will be reading the items
  112. outof one dialog (with help from Agent VU) and a new dialog appears in front 
  113. of the one VU is reading.  VU continues to read dialog items, but it is 
  114. getting them from the new front most dialog.  The effect is to create a window
  115. descriptor whose content list is a mixture of both dialogs.  An example where
  116. this might happen is with printer dialogs.
  117.  
  118. 5.    When you abort VU using cmd-. while a test is in progress, VU 
  119. takes an extended period of time before it finishes its abort process.  Part 
  120. of this is due to the fact that VU has to abort any pending network 
  121. transactions and do some other clean up.
  122.  
  123. 6.    Typed keys on target machines may be repeated when running 
  124. on busy networks.  This problem may be partially or completely 
  125. elimintated by making sure that key repeat is set to off with the
  126. Keyboard control panel on each target.
  127.  
  128. 7.    The screen size of a target may be improperly reported if a 
  129. system is transferred across machine types.  For example, if a system
  130. running on a Mac SE had previously been running on a Mac II with a
  131. color monitor, the screen size of the color monitor will most 
  132. likely be reported.  If the system is transferred to a machine with a 
  133. configurable monitor setup, this problem can be corrected by running 
  134. the Monitors control panel.  Otherwise, the workaround is to install 
  135. systems specifically for the machine on which it will be running.
  136.  
  137. 8.     Aborting a script during a typing operation on a target may 
  138. cause the last typed key to remain in the key down position.  It 
  139. will remain that way until the key is typed again (manually or by VU).
  140.  
  141. 9. Under System 7.0a9, the location of content items in control 
  142. panel windows and in the Chooser will be skewed in relation to their
  143. real on-screen location.  This will be fixed at least for control panel
  144. windows in upcoming developer-seeded versions of System 7.0.
  145.  
  146.  
  147. Reporting Problems
  148.  
  149. To report problems, please use Outside Bug Reporter and/or link to 
  150. MACDTS.  The following is most helpful when reporting problems:
  151.  
  152. 1.    Version numbers for all components of Virtual User you are 
  153. using.  You can obtain the version of VU by using the -vers 
  154. command line option.
  155.  
  156. 2.    The smallest VU script that shows the problem.  In other 
  157. words, try to eliminate as much of the script as you can.  If 
  158. it's one statement that causes the problem, send us just that one
  159. statement.  Along with the script, describe the target state in terms of 
  160. what application the script is running against and what state the 
  161. app is in.
  162.  
  163. 3.    System configurations for both the target and the VU machine.
  164.  
  165. 4.    The network across which the test was being run.
  166.  
  167. Contact
  168.  
  169. There is a Virtual User forum for you on AppleLink.  Please post your 
  170. questions here.  The full path name to access it is:
  171. Developer Services:Macintosh Development Tool Discussion:Virtual User
  172.  
  173.